package com.bsdsma.visonManagementSystemapp.service;


import com.bsdsma.visonManagementSystemapp.dto.*;
import com.bsdsma.visonManagementSystemapp.entity.Gonggao;

import java.util.Date;
import java.util.List;

/**
* 公告业务操作接口声明
*/
public interface GonggaoService {

    /**
    * 分页查询公告
    *
    * @param dto   查询公告条件
    * @return      分页数据
    */
    PageRetDto<Gonggao> search(GonggaoSearchDto dto);

    /**
    * 查询所有公告
    */
    List<Gonggao> listAll();

    /**
    * 查询所有公告以及是否只查询了自己的数据标识
    */
    ListAllRetDto<Gonggao> listAllWithRet();

    /**
    * 添加公告
    * @param dto   添加的对象数据
    * @return      添加后的公告对象
    */
    Gonggao add(GonggaoAddDto dto);

    /**
    * 修改公告
    * @param id    主键ID
    * @param dto   修改数据
    * @return      修改后的公告对象
    */
    Gonggao update(Long id, GonggaoAddDto dto);

    /**
    * 通过ID查询
    * @param id    主键
    * @return      查询到的公告对象
    */
    Gonggao getById(Long id);


    /**
    * 删除公告
    * @param id    公告ID
    */
    void delete(Long id);

    /**
    * 更新公告
    * @param id    公告ID
    */
    int updateById(Gonggao entity);

    /**
    * 查询公告数量
    */
    Long count();

    /**
    * 按日期分组查询新增数量
    * @param beginDate 开始时间
    * @param endDate   结束时间
    * @return
    */
    List<DataGroupByDateDto> countByDay(Date beginDate, Date endDate);
}
